home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #5 / Amiga Plus CD - 2000 - No. 5.iso / t / AMPlifier_E.guide.bak.1 < prev    next >
Text File  |  2000-01-01  |  28KB  |  1,134 lines

  1. DATABASE "AMPlifier.guide"
  2. @AUTHOR "Thorsten Hansen/ported by JP"
  3. @-WORDWRAP
  4.  
  5. @NODE MAIN "AMPlifier Documentation"
  6.  
  7.                         @{b}AMPlifier@{ub}
  8.                        Version 2.0
  9.  
  10.                     MPEG Audio Player
  11.  
  12.                  © 1999 Thorsten Hansen
  13.                     @{i}Kato Development@{ui}
  14.  
  15.                   http://www.katodev.de
  16.  
  17. @{JLEFT}
  18.   @{" Introduction            " LINK INTRODUCTION}   Why using it?
  19.   @{" Requirements            " LINK REQUIREMENTS}   Things needed to get it work
  20.   @{" Usage                   " LINK USAGE       }   How it works
  21.   @{" Tooltypes and Arguments " LINK CONFIG      }   Configuration and Settings
  22.   @{" ARexx                   " LINK AREXX       }   ARexx Port
  23.  
  24.   @{" Registration            " LINK REGISTRATION}   How to get a full License of AMPlifier
  25.  
  26. @ENDNODE
  27.  
  28.  
  29. @NODE INTRODUCTION "Introduction"
  30. @TOC MAIN
  31. @{b}Introduction to AMPlifier@{ub}
  32.  
  33. AMPlifier primary is a playback tool for MPEG-Audio 
  34. (Musicam). Additionally it can be used to playback 16-bit 
  35. Sound stored into various file formats. AMPlifier makes it 
  36. possible to play MPEGs at nice and powerfull manner. It 
  37. may be used on any Amiga and supports hardware-based 
  38. decoding on one hand and software-based decodierung using 
  39. the mpega.library.
  40.  
  41.    supported hardware decoders actually are:
  42.  
  43.       Melody Z2, Melody1200+/pro, Peggy+ (ScalaMPEG), 
  44.       CD32-FMV
  45.  
  46.  
  47.    as said before software decoding is using mpega.library 
  48.    and AHI or X-Audio depending on user's needs.
  49.  
  50.  
  51. @{u}Features:@{uu}
  52.  
  53.   * Supports MPEG-Audio up to Layer III and even AIFF, 
  54.     MAUD, WAVE and RAW.
  55.  
  56.   * Ease of use, basic functionality known from CD-Players
  57.     (play, pause, stop, forward, backward, skip back, 
  58.      skipforward)
  59.  
  60.   * Powerful plugin system - for external visualization plugins
  61.  
  62.   * Resizeable and configureable user interface - easy to use
  63.  
  64.   * Loads WinAMP skins (different gfx designs)
  65.  
  66.   * Opens and moves to/from any public screen on your choice
  67.  
  68.   * Nice and fast move to any position in a song by using
  69.     a pos-slider
  70.  
  71.   * Powerfull Playlist (sortable, loop support).
  72.  
  73.   * Load, Save and Edit of playlists.
  74.  
  75.   * Random play
  76.  
  77.   * Simple drag&drop of files and drawers. (drop it over the
  78.     playlist window to add it)
  79.  
  80.   * Recursive scan through directorys with pattern matching 
  81.     (drag&drop). with possibility to abort!
  82.     (drop a drawer or volume on the player or playlist 
  83.      window)
  84.  
  85.   * ID3-Tag support to get closer and better infos from the 
  86.     songs played (artist, title, album, year,...)
  87.  
  88.   * Time remaining/elapsed display
  89.  
  90.   * ARexx port
  91.  
  92.   * Done as a Commodity
  93.  
  94.   ...
  95.  
  96.  
  97. @ENDNODE
  98.  
  99.  
  100. @NODE REQUIREMENTS "Hardware Requirements"
  101. @TOC MAIN
  102. @{b}Hardware and Softwarerequirements@{ub}
  103.  
  104. * AMPlifier works for any Amiga running AmigaOS 2.04 or 
  105.   better. While Developers machines are running OS 3.1 only
  106.   the player is enhanced and checked with 3.1 only.
  107.   Because of this the actual version 3 of the OS should 
  108.   be used.
  109.  
  110.  
  111. * Regarding MPEG AMPlifier supports DSP based decoding of 
  112.   Soundboards and even simple Soundboards or output of 
  113.   traditional Amiga. If Software decoding is used only
  114.   @{b}mpega.library@{ub} done by Stephan Tavenard is 
  115.   required.
  116.   For hardware which supports MPEG a proper mpeg.device 
  117.   (CBM's  definition for CD32) is required and must be 
  118.   selected in the settings of AMPlifier.
  119.  
  120. @ENDNODE
  121.  
  122.  
  123. @NODE USAGE "Usage"
  124. @TOC MAIN
  125. @{b}Usage@{ub}
  126.  
  127. AMPlifier may be started from Workbench or Shell.
  128. The GUI is equvalent to the user interface of a generic 
  129. CD-Player.
  130. At PullDown menue an additional playlist window may get 
  131. opened. It contains the list of songs which will be played. 
  132. By klicking one of the entries in the list it's possible to 
  133. start that song immediately. This mechanism may even be 
  134. used to skip one ore more songs or play one or more a 
  135. second time.
  136.  
  137. If songs are given to the player using Drag-and-Drop or the
  138. filerequester (multiselect capability) the old playlist
  139. will get removed and a new one containing the last choice 
  140. will show up. To add songs to the playlist they have to be
  141. dropped over the playlist window or may get added with a 
  142. filerequester by using the ADD button.
  143.  
  144. Unkown file formats won't be accepted in default setup. 
  145. This may get changed via a a @{" Tooltype " LINK CONFIG} 
  146. to enable playback of headerless RAW samples 
  147. (Big-Endian, MSB first, Motorola).  
  148.  
  149. The windows of player and playlist are variable in size. 
  150. While the sizegadget is visable at playlist, it's invisable
  151. at the player itself. It's still there, though.
  152.  
  153.  
  154. @{" Menus         " LINK MENUS}
  155.  
  156. @{" Player        " LINK WIN_PLAYER}
  157. @{" Playlist      " LINK WIN_PLAYLIST}
  158. @{" Configuration " LINK WIN_CONFIG}
  159.  
  160. @ENDNODE
  161.  
  162. @NODE MENUS "Menues"
  163. @TOC USAGE
  164. @{b}Menues@{ub}
  165.  
  166. @{" Project       " LINK MENU_PROJECT}
  167. @{" Settings      " LINK MENU_SETTINGS}
  168.  
  169. @ENDNODE
  170.  
  171. @NODE MENU_PROJECT "Project"
  172.  
  173. @{b}@{u}Project@{ub}@{uu}
  174.  
  175. @{b}Open...@{ub}
  176.   Opens an ASL-Filerequester for selecting songs to play
  177.  
  178. @{b}Add...@{ub}
  179.   Opens an  ASL-Filerequester to add one song or a list of 
  180.   songs to playlist
  181.  
  182. @{b}Playlist...@{ub}
  183.   Opens the window of the playlist.
  184.  
  185. @{b}Load Playlist...@{ub}
  186.   Loading of an previously saved playlist.
  187.   The name will be requested by a Filerequester.
  188.  
  189. @{b}Save Playlist...@{ub}
  190.   Saves actual playlist into a file.
  191.  
  192. @{b}About@{ub}
  193.   Displays a window which contains infos to AMPlifier an 
  194.   its designer/programmer.
  195.  
  196. @{b}Hide@{ub}
  197.   Hides the GUI of the player. As this is a so called 
  198.   Commodity feature the tool Exchange (comes with the OS)
  199.   may be used to redisplay it again.
  200.  
  201. @{b}Quit@{ub}
  202.   This entry hopefully won't be used at all as it simply 
  203.   quits the programm. The function is equivalent to the 
  204.   close gadget at the player's window.
  205.  
  206. @ENDNODE
  207.  
  208. @NODE MENU_SETTINGS "Settings"
  209.  
  210. @{b}@{u}Settings@{uu}@{ub}
  211.  
  212. @{b}Configuration...@{ub}
  213.   The item opens the configuration window of AMPlifier.
  214.  
  215. @{b}Random@{ub}
  216.   If Random is checked titles in the list are played at
  217.   random order.
  218.  
  219. @{b}Loop@{ub}
  220.   After all songs are played the player doesn't stop but
  221.   plays the list again (if checked).
  222.  
  223. @{b}Time Elapsed / Time Remaining@{ub}
  224.   Switches display to time remaining instead of time 
  225.   elapsed.
  226.  
  227. @{b}Display@{ub}
  228.  
  229.   @{u}Standard GUI@{uu}
  230.  
  231.   @{b}Info@{ub}
  232.     Activates the part of the GUI which displays the 
  233.     line which contains infos regaring the currently played 
  234.     song
  235.  
  236.   @{b}Slider@{ub}
  237.     Activates position slider at the GUI.
  238.  
  239.   @{b}Panel@{ub}
  240.     Activates the CD-Player panel of player's GUI
  241.  
  242.   @{u}Skin GUI@{uu}
  243.  
  244.   @{b}Select Skin...@{ub}
  245.     It pops up a window  which shows the list of different 
  246.     skins which are available in the skins directory 
  247.     (look for at WinAMP skins in Internet if you like).
  248.     The skins directory can be selected in the 
  249.     configuration window of the player.
  250.     
  251.  
  252. @{b}Public Screen@{ub}
  253.   This item opens a list window which contains the public 
  254.   screens on which AMPlifer may be moved to.
  255.   
  256. @{b}Snapshot@{ub}
  257.   This one snaps position and size of the player windows 
  258.   and stores the information for the next start of the 
  259.   program. 
  260.  
  261.  
  262. @ENDNODE
  263.  
  264. @NODE WIN_PLAYER "Player"
  265. @TOC USAGE
  266. @{b}Player@{ub}
  267.  
  268. The userinterface was done euivalent to that one of a 
  269. generic CD player. Same functionality is available at 
  270. AMPlifier.
  271.  
  272. There are buttons for @{i}Play@{ui}, @{i}Stop@{ui}, @{i}Pause@{ui} and for
  273. Skipping and Jump back to previously played songs.
  274.  
  275. The first way to do a list of songs for playback is
  276. a filerequester which even allows multiselection.
  277. It's even possible to choose the whole directory with the
  278. filerequester if no file is selected.
  279.  
  280. The other and maybe easier way is to drag and drop
  281. files, directories or even volumes over/into the 
  282. player window. In case of a directory or volume 
  283. AMPlifier will recursively scan it for files it's 
  284. able to play back. These files will be listed in the 
  285. playlist window.
  286.  
  287.  
  288. @ENDNODE
  289.  
  290. @NODE WIN_PLAYLIST "Playlist"
  291. @TOC USAGE
  292. @{b}Playlist@{ub}
  293.  
  294. Like the name tries to tell this is the window which 
  295. includes and shows the list of titles to play.
  296. Each file is displayed with length (min:secs) and
  297. name.
  298. MPEG-files may contain so called ID3 Tag informations
  299. appended to the sound data. If such Tag is available
  300. closer info will be or may be shown in the list.
  301.  
  302. In the top area of the playlist's window there are
  303. buttons which represent functions for editing the 
  304. playlist. One or more files may be @{b}Add@{ub}ed to the 
  305. actual playlist. The filerequester supports selection of
  306. multible files (shift key!). 
  307.  
  308. There are buttions to @{b}Remove@{ub} entries or 
  309. @{b}Clear@{ub} the whole list. Additionally there is
  310. a buttion to @{b}Sort@{ub} the list in alphabetical order.
  311.  
  312. As long as the player scans directories recursively 
  313. (volumes or directories, their subdirectories and so on)
  314. there will be a temporary break button in the bottom of the 
  315. window. If will disappear when the scan is finished.
  316. It was done to stop scans which take too long maybe 
  317. because of and accidently selected Workbench partition
  318. or something equivalent.
  319. Entries in the playlist which are/were played will change
  320. from bold font to normal font. 
  321.  
  322. A very special bonbon of the GUI is the XY-scrolling 
  323. Listview which does softscrolling using any font! Up to 
  324. programmers knowledge it's a unique GUI element at Amiga
  325. up to now.
  326.  
  327. @ENDNODE
  328.  
  329. @NODE WIN_CONFIG "Configuration"
  330. @TOC USAGE
  331. @{b}Configuration@{ub}
  332.  
  333. @{" General       " LINK CFG_GENERAL}
  334. @{" Display       " LINK CFG_DISPLAY}
  335. @{" Output        " LINK CFG_Output}
  336. @{" MPEG          " LINK CFG_MPEG}
  337.  
  338. @ENDNODE
  339.  
  340. @NODE CFG_GENERAL "General"
  341. @TOC WIN_CONFIG
  342. @{b}General@{ub}
  343.  
  344. @{b}@{u}Load@{uu}@{ub}
  345.  
  346. @{b}Check filetype information on load@{ub}
  347.   This checkbox forces AMPlifier to check filetypes while 
  348.   building the playlist. Files of types it doesn't know 
  349.   won't be shown at the playlist.
  350.  
  351.   This confguration topic doesn't prevent AMPlifier to 
  352.   check any file before it plays it back, though.
  353.  
  354. @{b}ID3-Tag Info@{ub}
  355.   ID3-Tag is an information block which may be appended to
  356.   MPEG audio files. It usually contains title, interpret,
  357.   style etc. A checked box tells AMPlifier to read this 
  358.   information out of the file.
  359.   As some computers are quite slow (usually wrong 
  360.   blocksize of harddisk...take OS 3.1 and 2048 byte/block)
  361.   it's even possible to select the time when AMPlifier has 
  362.   a look at the data. The options are 1st: while it builds
  363.   the playlist or 2nd: when song starts playing.
  364.  
  365.   There is a coded string which defines the format of the 
  366.   display (have a look at the default settings to 
  367.   understand).
  368.  
  369.   No question a title which doesn't contain such info data
  370.   won't allow AMPlifier to display the data!
  371.   There are several tools which may be used to enter or 
  372.   modify ID3-Tags.  
  373.  
  374.   As there is a problem with ID3 regarding broadcasting 
  375.   (it's starting to be available when the song finished)
  376.   there is a new standard at the horizont. AMPlifier will
  377.   even support it when it's finished.
  378.  
  379.  
  380. @{b}Start playback@{ub}
  381.   As said before the scan of a big or slow dataset may take 
  382.   a longer time. AMPlifier is able to start playback before 
  383.   the whole list is ready.
  384.   The time (in seconds) it should wait until starting the 
  385.   first song may be entered here, too.
  386.  
  387.   Attention: If a very short time is choosen random play
  388.   will allways start with the same song(s) for sure. 
  389.  
  390.  
  391. @{b}@{u}Misc@{uu}@{ub}
  392.  
  393. @{b}Song Dir@{ub}
  394.   Default directory for songs.
  395.  
  396. @{b}Playlist Dir@{ub}
  397.   Default directory for playlists.
  398.  
  399. @{b}Start File@{ub}
  400.   This feature allows the user to pre-define a title or a
  401.   directory of songs AMPlifier will start to play when
  402.   just started.
  403.  
  404. @{b}File Pattern@{ub}
  405.   File pattern limits the search for playable files by their
  406.   extention (f.e. #?.mp3). As AMPlifier doesn't have to 
  407.   spend a look into each file it usually speeds up scanning
  408.   by factors.
  409.  
  410. @{b}Activate on Doubleclick@{ub}
  411.   If user is currently edditing the playlist in background 
  412.   it may be a bad idea to start playback of a song as soon 
  413.   as it's selected by a single mouse click.
  414.  
  415.   Activate on doubleclick transforms the behavior to  
  416.   1st: mark on single click and
  417.   2nd: play this song now
  418.  
  419.   It's up to users chioce what's current optimum.
  420.  
  421. @ENDNODE
  422.  
  423. @NODE CFG_DISPLAY "Display"
  424. @TOC WIN_CONFIG
  425. @{b}Display@{ub}
  426.  
  427. @{b}Skins@{ub}
  428.   Beside the traditional GUI which shows up by default, so 
  429.   called skins known from PC's WinAMP may be used. This 
  430.   drawn GUIs are often difficult to look at (not 
  431.   economical) and don't offer the feature of resizing. 
  432.   Regarding useablity they're bad but fresh and colorfull
  433.   on the other hand. 
  434.   
  435.   If skins are used the GUI includes a display area for
  436.   @{i}Volume Meter@{ui}, @{i}Oscilloscope@{ui} or @{i}
  437.   Spectrum Analyzer@{ui}. Click left below the time 
  438.   display for toggling
  439.  
  440.    (If Melody1200 with MPEG hardware support is build into 
  441.     the machine special hardware is used to display the 
  442.     analysis graphics!).
  443.  
  444.   At this area the directory which contains the skins 
  445.   may and should be entered.
  446.  
  447.   The Skins from PC world are done in Truecolor. If they're 
  448.   used at an Amigascreen which offers a lower number of
  449.   colors (usually true for A1200) the may loog quite ugly.
  450.   
  451.   Even less colors look nice if color reduction is done.
  452.   If the skin does't look very nice take color reduced ones
  453.   or do the reduction yourself if you can.
  454.   Sometimes there are stronger problems regarding display
  455.   of skins. Usually the @{b}picture.datatype@{ub} is 
  456.   defective/old and slow. Take a new one!
  457.  
  458.   As soon as Skins are enabled a new menue bar will be 
  459.   shown in @{i}Settings@{ui} Menue.
  460.   That's the place where skins may be changed and selected.
  461.  
  462. @ENDNODE
  463.  
  464. @NODE CFG_OUTPUT "Output"
  465. @TOC WIN_CONFIG
  466. @{b}Output@{ub}
  467.  
  468. @{b}Output Device@{ub}
  469.   It's possible to select output drivers (device) and unit 
  470.   numbers for MPEG hardware and even simple audio output.
  471.   If there is more than one board using the same driver 
  472.   you'll have to specify it by using unit numbers. 
  473.  
  474.   For example it's even possible to use two Melody1200PRO
  475.   in a A1200 (one on top of the other).
  476.   Closer information available on request.
  477.  
  478.   @{b}MPEG@{ub}
  479.     For  Melody 1200 pro and plus take 'mel1200mpeg.device'.
  480.     Users of Peggy should enter 'peggympeg.device'.
  481.  
  482.   @{b}Audio@{ub}
  483.     That's the name of the Audio Device 
  484.     (mel1200audio.device for all Melody1200 boards).
  485.  
  486.   @{b}Use AHI@{ub}
  487.     If there are people who unfortunately don't have got
  488.     a Melody1200 available in their A1200 or Zorro Amiga,
  489.     AHI may be choosen.
  490.     If AHI is used it's even possible to start more 
  491.     instances of AMPlifer and play back on the same 
  492.     hardware (AHI does the mixing).
  493.  
  494. @{b}File Buffer@{ub}
  495.   That's the size of the overall file buffer. AMPlifer 
  496.   makes use of multibuffering for smooth playback.
  497.  
  498.   Blocksize specifies the size of one particular buffer.
  499.   The overall buffersize is splitted into a calculated 
  500.   number of small buffers with the size of Blocksize.
  501.  
  502.   @{i}Attention:@{ui} If Peggy+, ScalaFMV is used, the 
  503.   maximum value is 5 kB only (bug in its device).
  504.  
  505. @{b}Audio@{ub}
  506.   The size of the audio {b}Buffer@{ub} in seconds is 
  507.   selected here.
  508.   If hardware baded decoding is used the value is ignored.
  509.   It's used for playback of raw files and software based 
  510.   MPEG decoding, only.
  511.   
  512.   Primary when using software decoding there may be short 
  513.   interrupts when an MPEG file just started playback or the
  514.   positioning slider is moved.
  515.   To avoid these kind of short interrupts 
  516.   @{b}Pre-Buffering@{ub} may be used.
  517.   Via this setting it's possible to define how much of the
  518.   audio buffer has to be filled (in percent) until audible 
  519.   playback starts. 
  520.  
  521.   Additionally the user may modify the @{b}Priority@{ub} 
  522.   of the audio Task. A priority of 20 or more is recomended
  523.   in case of problems.
  524.   Finally it strongly depends on the machine and its CPU
  525.   which is used for playback.
  526.  
  527. @ENDNODE
  528.  
  529. @NODE CFG_MPEG "MPEG"
  530. @TOC WIN_CONFIG
  531. @{b}MPEG@{ub}
  532.  
  533. At the MPEG configuration user has got the choice of doing 
  534. software or hardware based decoding.
  535. This can be configured seperately for MPEG Audio Layer I/II 
  536. and for Layer III.
  537.  
  538.  
  539. @{i}Attention:@{ui} If DSP based decoding is wanted the options
  540.            have to be @{b}disabled@{ub}. Otherwise the DSP won't
  541.            be used and main CPU takes tons of work instead!
  542.  
  543.  
  544. @ENDNODE
  545.  
  546. @NODE CONFIG "Configuration"
  547. @TOC MAIN
  548. @{b}Settings and Parameters@{ub}
  549.  
  550. There are several options which may selected via tooltypes
  551. or as a parameter in the shell. 
  552.  
  553. Following Tooltypes are available in programm's Icon:
  554.  
  555. @{b}CONFIG=Prefsfile@{ub}
  556.   Prefsfile is a file into which AMPlifier stores its 
  557.   configuration. It's probably only usefull to change the
  558.   name if there is more than one instance if AMPlifier 
  559.   running with different configuration. 
  560.   (Default: ENVARC:AMPlifier.prefs)
  561.  
  562. @{b}CX_POPUP=Yes/No@{ub}
  563.   This Tooltype is a standard one of AmigaOS.
  564.   If 'No' is entered, AMPlifier starts up as an AppIcon 
  565.   only. The GUI is not visable for first. 
  566.   This is equivalent to iconify in pull-down-menue of 
  567.   AMPlifier.
  568.  
  569. @{b}CX_POPKEY=Hotkey@{ub}
  570.   Hotkey defines the kombination of keys which
  571.   (re-)activates the GUI. 
  572.   (Default: @{i}shift-F1@{ui})
  573.  
  574. @{b}CX_PRIORITY=pri@{ub}
  575.   Defines the startup priority of Commodity 
  576.   (standard feature)
  577.  
  578. @{b}MPEGDevice=MPEGDeviceName@{ub}
  579.   This is where the Device Name of the MPEG Hardware is 
  580.   entered.
  581.   For Melody 1200 pro und plus take 'mel1200mpeg.device'.
  582.   Peggy User should take 'peggympeg.device' instead.
  583.  
  584.   (mpeg.device not xaudio.device !!!)
  585.  
  586. @{b}MPEGUnit=Nummer@{ub}
  587.   Identification of more than one Soundboards using the 
  588.   same device (default: 0)
  589.  
  590.   (unit mpeg.device not xaudio.device !!!)
  591.  
  592. @{b}AudioDevice=AudioDeviceName@{ub}
  593.   This is the name of the Audio Hardware.
  594.   Regarding Melody1200 'mel1200audio.device' is the right
  595.   choice.
  596.  
  597.   (xaudio.device not mpeg.device !!!)
  598.  
  599. @{b}AudioUnit=Nummer@{ub}
  600.   Identification of more than one Soundboards using the 
  601.   same device (default: 0)
  602.  
  603.   (unit of xaudio.device not mpeg.device !!!)
  604.  
  605. @{b}BlockSize=Blocksize in KBytes@{ub}
  606.   Blocksize specifies the size of one particular buffer.
  607.   The overall buffersize is splitted into a calculated 
  608.   number of small buffers with the size of Blocksize.
  609.  
  610. @{b}BuffSize=Overall size of memory used for buffering@{ub}
  611.   That's the size of the overall file buffer. AMPlifer 
  612.   makes use of multibuffering for smooth playback.
  613.  
  614. @{b}noAppIcon@{ub}
  615.   The player doesn't show an AppIcon on Workbench.
  616.  
  617. @{b}PubScreen=ScreenName@{ub}
  618.   Screenname is one of the allready opened Public 
  619.   Screens on which AMPlifier will open its GUI on.
  620.  
  621. @{b}AudioPri=Priorität@{ub}
  622.   This is the priority of the Audio task (default 21)
  623.  
  624. @{b}RemainingTime@{ub}
  625.   The player doesn't display time elapsed but the time 
  626.   remaining.
  627.  
  628. @{b}Pattern=\#?.(MP2|AIFF|WAV|MAUD)@{ub}
  629.   At filerequesters only files matching the pattern are 
  630.   displayed.
  631.  
  632. @{b}Random@{ub}
  633.   The Player plays all entries at random order instead
  634.   of alphabetical order.
  635.   
  636. @{b}Loop@{ub}
  637.   AMPlifier doesn't stop playback after the whole list
  638.   is finished but restarts playback again.
  639.  
  640. @{b}CDDA@{ub}
  641.   If CDDA is not activated, it's not possible to playback 
  642.   unknown filetypes which don't contain a header.
  643.   By default it's deactivated to protect AMPlifier from 
  644.   playing back f.e. non-audio files.
  645.  
  646. @{b}CDDAIntel@{ub}
  647.   For CDDA files (raw) there are two different orderings
  648.   which have got their root at CPU level. The flag enables
  649.   playback of foreign data.
  650.   As CDDA is headerless it's usually required to check it
  651.   out or know about the data before.
  652.  
  653. @{b}StopBeforeScan@{ub}
  654.   Before AMPlifier plays back a new song it checks if  
  655.   knows the filetype.
  656.   At some configurations it's a problem if one song is 
  657.   currently played and a second one is scanned to identify
  658.   it. Using this flag AMPlifer will stop the previous
  659.   song until having a look at the next one.
  660.  
  661. @{b}Visual=1,2,3@{ub}
  662.   This is used to select the display which is used at the
  663.   the skin GUI.
  664.   1=Volume Meter, 2=Oscilloscope, 3=Spectrum Analyzer
  665.  
  666. @{b}SAScale=spectrum scale@{ub}
  667.   This is the scaling of the frequency range at the 
  668.   Spectrum Analyzer Effect.
  669.  
  670. @{b}VisualPri=pri@{ub}
  671.   This is the priority of the Visualization task
  672.  
  673. Many options are even available as shell arguments
  674. The meaning is equivalent to the WB Tooltypes.
  675.  
  676.     FILENAME=StartFile
  677.     CONF=CONFIGFILE
  678.     CX_POPUP=<YES/NO>
  679.     DEV=DEVICENAME
  680.     U=UNIT
  681.     BUFF=BUFFERSIZE
  682.     BLOCK=BLOCKSIZE
  683.     PS=PUBLICSCREEN
  684.  
  685.  
  686. @ENDNODE
  687.  
  688. @NODE AREXX "ARexx"
  689. @TOC MAIN
  690.  
  691. @{b}AMPlifier ARexx-Port@{ub}
  692.  
  693. The ARexx port of AMPlifier is accessable @{b}AMPLIFIER.1@{ub}. 
  694. Additional instance of AMPlifier gets the port @{b}AMPLIFIER.2@{ub} 
  695. and so on.
  696.  
  697. Following ARexx commands available at AMPlifier's port:
  698.  
  699.    @{" QUIT          " LINK QUIT}   
  700.    @{" HIDEGUI       " LINK HIDEGUI} 
  701.    @{" SHOWGUI       " LINK SHOWGUI} 
  702.    @{" OPEN          " LINK OPEN}   
  703.    @{" PLAY          " LINK PLAY}   
  704.    @{" STOP          " LINK STOP}   
  705.    @{" PLAYPAUSE     " LINK PLAYPAUSE}
  706.    @{" PAUSE         " LINK PAUSE}   
  707.    @{" PLAYNEXT      " LINK PLAYNEXT}
  708.    @{" PLAYPREV      " LINK PLAYPREV}
  709.    @{" SELECT        " LINK SELECT}
  710.    @{" QUERYSELECTED " LINK QUERYSELECTED}
  711.    @{" SEEK          " LINK SEEK}
  712.    @{" VOLUME        " LINK VOLUME}
  713.    @{" WAIT          " LINK WAIT}
  714.    @{" WAITABORT     " LINK WAITABORT}
  715.    @{" ADD           " LINK ADD}
  716.    @{" REM           " LINK REM}
  717.    @{" CLEAR         " LINK CLEAR}
  718.    @{" SORTLIST      " LINK SORTLIST}
  719.  
  720.    @{" PLAYSTATE     " LINK PLAYSTATE}
  721.    @{" GETTIME       " LINK GETTIME}
  722.    @{" GETLENGTH     " LINK GETLENGTH}
  723.    @{" GETTAGINFO    " LINK GETTAGINFO}
  724.  
  725. @ENDNODE
  726.  
  727.  
  728. @NODE QUIT "QUIT"
  729. @TOC AREXX
  730.  
  731. @{b}@{u}QUIT@{uu}@{ub}
  732.  
  733. @{i}Template@{ui}
  734.     -
  735.  
  736. @{i}Description@{ui}
  737.     Quits AMPlifier
  738.  
  739. @ENDNODE
  740.  
  741. @NODE HIDEGUI "HIDEGUI"
  742. @TOC AREXX
  743.  
  744. @{b}@{u}HIDEGUI@{uu}@{ub}
  745.  
  746. @{i}Template@{ui}
  747.     -
  748.  
  749. @{i}Description@{ui}
  750.     Hides graphical user interface
  751.  
  752. @ENDNODE
  753.  
  754. @NODE SHOWGUI "SHOWGUI"
  755. @TOC AREXX
  756.  
  757. @{b}@{u}SHOWGUI@{uu}@{ub}
  758.  
  759. @{i}Template@{ui}
  760.     -
  761.  
  762. @{i}Description@{ui}
  763.     Shows graphical user interface
  764.  
  765. @ENDNODE
  766.  
  767. @NODE OPEN "OPEN"
  768. @TOC AREXX
  769.  
  770. @{b}@{u}OPEN@{uu}@{ub}
  771.  
  772. @{i}Template@{ui}
  773.     TITLE/A
  774.  
  775. @{i}Description@{ui}
  776.     Tries to open a file with name given
  777.  
  778. @ENDNODE
  779.  
  780. @NODE PLAY "PLAY"
  781. @TOC AREXX
  782.  
  783. @{b}@{u}PLAY@{uu}@{ub}
  784.  
  785. @{i}Template@{ui}
  786.     TITLE,INDEX/N/K
  787.  
  788. @{i}Description@{ui}
  789.     If no argument is passed the current song is played;
  790.     With argument given the specified file will be loaded
  791.     if possible.
  792.     If index argument is used the number of the entry in 
  793.     playlist is played (topmost argument is 0).
  794.  
  795. @ENDNODE
  796.  
  797. @NODE STOP "STOP"
  798. @TOC AREXX
  799.  
  800. @{b}@{u}STOP@{uu}@{ub}
  801.  
  802. @{i}Template@{ui}
  803.     -
  804.  
  805. @{i}Description@{ui}
  806.     Stops playback of current song
  807.  
  808. @ENDNODE
  809.  
  810. @NODE PLAYPAUSE "PLAYPAUSE"
  811. @TOC AREXX
  812.  
  813. @{b}@{u}PLAYPAUSE@{uu}@{ub}
  814.  
  815. @{i}Template@{ui}
  816.     -
  817.  
  818. @{i}Description@{ui}
  819.     Each call toggles play und pause
  820.  
  821. @ENDNODE
  822.  
  823. @NODE PAUSE "PAUSE"
  824. @TOC AREXX
  825.  
  826. @{b}@{u}PAUSE@{uu}@{ub}
  827.  
  828. @{i}Template@{ui}
  829.     -
  830.  
  831. @{i}Description@{ui}
  832.     Pauses playback of current song
  833.  
  834. @ENDNODE
  835.  
  836. @NODE PLAYNEXT "PLAYNEXT"
  837. @TOC AREXX
  838.  
  839. @{b}@{u}PLAYNEXT@{uu}@{ub}
  840.  
  841. @{i}Template@{ui}
  842.     -
  843.  
  844. @{i}Description@{ui}
  845.     Plays next title in playlist
  846.     If random mode is activated, the next random title is 
  847.     played.
  848.  
  849. @ENDNODE
  850.  
  851. @NODE PLAYPREV "PLAYPREV"
  852. @TOC AREXX
  853.  
  854. @{b}@{u}PLAYPREV@{uu}@{ub}
  855.  
  856. @{i}Template@{ui}
  857.     -
  858.  
  859. @{i}Description@{ui}
  860.     Plays previous title
  861.  
  862. @ENDNODE
  863.  
  864. @NODE SELECT "SELECT"
  865. @TOC AREXX
  866.  
  867. @{b}@{u}SELECT@{uu}@{ub}
  868.  
  869. @{i}Template@{ui}
  870.     INDEX/N/K,NEXT/S,PREV=PREVIOUS/S,TOP/S,BOTTOM/S
  871.  
  872. @{i}Description@{ui}
  873.     Selects titel in playlist
  874.  
  875. @ENDNODE
  876.  
  877. @NODE QUERYSELECTED "QUERYSELECTED"
  878. @TOC AREXX
  879.  
  880. @{b}@{u}QUERYSELECTED@{uu}@{ub}
  881.  
  882. @{i}Template@{ui}
  883.     PLAYED/S,INDEX/S,NAME/S,LABEL/S
  884.  
  885. @{i}Description@{ui}
  886.     Returns informations to selected title in playlist 
  887.  
  888. @ENDNODE
  889.  
  890. @NODE SEEK "SEEK"
  891. @TOC AREXX
  892.  
  893. @{b}@{u}SEEK@{uu}@{ub}
  894.  
  895. @{i}Template@{ui}
  896.     SEC/N/A
  897.  
  898. @{i}Description@{ui}
  899.     Jumps to a specified position in actual title 
  900.     (seconds from start).
  901.  
  902. @ENDNODE
  903.  
  904. @NODE VOLUME "VOLUME"
  905. @TOC AREXX
  906.  
  907. @{b}@{u}VOLUME@{uu}@{ub}
  908.  
  909. @{i}Template@{ui}
  910.     LEVEL/N
  911.  
  912. @{i}Description@{ui}
  913.     Set volume to (0-64).
  914.     If no argument is passed actual volume is returned
  915.  
  916. @ENDNODE
  917.  
  918. @NODE WAIT "WAIT"
  919. @TOC AREXX
  920.  
  921. @{b}@{u}WAIT@{uu}@{ub}
  922.  
  923. @{i}Template@{ui}
  924.     -
  925.  
  926. @{i}Description@{ui}
  927.     Wait until song is finished (synchronous) 
  928.  
  929. @ENDNODE
  930.  
  931. @NODE WAITABORT "WAITABORT"
  932. @TOC AREXX
  933.  
  934. @{b}@{u}WAITABORT@{uu}@{ub}
  935.  
  936. @{i}Template@{ui}
  937.     -
  938.  
  939. @{i}Description@{ui}
  940.     Breaks @{" WAIT " LINK WAIT} command
  941.  
  942. @ENDNODE
  943.  
  944. @NODE ADD "ADD"
  945. @TOC AREXX
  946.  
  947. @{b}@{u}ADD@{uu}@{ub}
  948.  
  949. @{i}Template@{ui}
  950.     TITLES/M
  951.  
  952. @{i}Description@{ui}
  953.     Adds one or more files or directories from playlist
  954.     
  955. @ENDNODE
  956.  
  957. @NODE REM "REM"
  958. @TOC AREXX
  959.  
  960. @{b}@{u}REM@{uu}@{ub}
  961.  
  962. @{i}Template@{ui}
  963.     -
  964.  
  965. @{i}Description@{ui}
  966.     Removes an entry from playlist
  967.  
  968. @ENDNODE
  969.  
  970. @NODE CLEAR "CLEAR"
  971. @TOC AREXX
  972.  
  973. @{b}@{u}CLEAR@{uu}@{ub}
  974.  
  975. @{i}Template@{ui}
  976.     -
  977.  
  978. @{i}Description@{ui}
  979.     Clears playlist
  980.  
  981. @ENDNODE
  982.  
  983. @NODE SORTLIST "SORTLIST"
  984. @TOC AREXX
  985.  
  986. @{b}@{u}SORTLIST@{uu}@{ub}
  987.  
  988. @{i}Template@{ui}
  989.     -
  990.  
  991. @{i}Description@{ui}
  992.     Sorts playlist in alphabetical order
  993.  
  994. @ENDNODE
  995.  
  996. @NODE PLAYSTATE "PLAYSTATE"
  997. @TOC AREXX
  998.  
  999. @{b}@{u}PLAYSTATE@{uu}@{ub}
  1000.  
  1001. @{i}Template@{ui}
  1002.     -
  1003.  
  1004. @{i}Description@{ui}
  1005.     Ask for state of the players
  1006.  
  1007. @{i}Result@{ui}
  1008.     1=Stop
  1009.     2=Pause
  1010.     3=Playback
  1011.  
  1012. @ENDNODE
  1013.  
  1014. @NODE GETTIME "GETTIME"
  1015. @TOC AREXX
  1016.  
  1017. @{b}@{u}GETTIME@{uu}@{ub}
  1018.  
  1019. @{i}Template@{ui}
  1020.     -
  1021.  
  1022. @{i}Description@{ui}
  1023.     Ask for time elapsed (per song).
  1024.  
  1025. @{i}Result@{ui}
  1026.     Time in seconds
  1027.  
  1028. @ENDNODE
  1029.  
  1030. @NODE GETLENGTH "GETLENGTH"
  1031. @TOC AREXX
  1032.  
  1033. @{b}@{u}GETLENGTH@{uu}@{ub}
  1034.  
  1035. @{i}Template@{ui}
  1036.     -
  1037.  
  1038. @{i}Description@{ui}
  1039.     Ask for length of current title
  1040.  
  1041. @{i}Result@{ui}
  1042.     Length in seconds
  1043.  
  1044. @ENDNODE
  1045.  
  1046. @NODE GETTAGINFO "GETTAGINFO"
  1047. @TOC AREXX
  1048.  
  1049. @{b}@{u}GETTAGINFO@{uu}@{ub}
  1050.  
  1051. @{i}Template@{ui}
  1052.     STEM/K
  1053.  
  1054. @{i}Description@{ui}
  1055.     Returns ID3-TAG informations into a 
  1056.     pre-defined variable 
  1057.     
  1058. @{i}Result@{ui}
  1059.     READY    0 - no ID3-TAG infos available
  1060.              1 - following infos are available
  1061.                  
  1062.     TITLE    
  1063.     ARTIST   
  1064.     ALBUM    
  1065.     YEAR     
  1066.     COMMENT  
  1067.     GENRE    
  1068.  
  1069. @{i}Example@{ui}
  1070.  
  1071.     OPTIONS RESULTS
  1072.  
  1073.     ADDRESS AMPLIFIER.1
  1074.  
  1075.     GETTAGINFO STEM tag
  1076.  
  1077.     IF tag.ready = "1" THEN DO
  1078.       SAY "Title:" tag.title
  1079.       SAY "Artist:" tag.artist
  1080.       SAY "Album:" tag.album
  1081.       SAY "Year:" tag.year
  1082.       SAY "Comment:" tag.comment
  1083.       SAY "Genre:" tag.genre
  1084.     END
  1085.  
  1086. @ENDNODE
  1087.  
  1088. @NODE REGISTRATION "Registration"
  1089. @TOC MAIN
  1090.  
  1091. @{b}Registration@{ub}
  1092.  
  1093. @{u}Melody Users@{uu}
  1094. If you're proud owner of a Melody Z2/Melody 1200 Soundboard,
  1095. AMPlifier is unlimited for you. There is no need for 
  1096. registration.
  1097.  
  1098. @{u}All others:@{uu}
  1099. AMPlifier is Shareware. If you're using it for a longer 
  1100. time then about two weeks you have to register.
  1101.  
  1102. The shareware price is 15,- Euro,
  1103.                        30,- DM.
  1104.  
  1105. Registered users will receive a personal keyfile. Inside the
  1106. Keyfile your coded data is stored. 
  1107. One license includes one computer only and for you it's
  1108. not allowed to give it to someone else.
  1109.  
  1110. Unless noted differently the common rules for shareware are
  1111. even true for AMPlifier.
  1112.  
  1113. The Keyfile will be send out uuencoded via EMail.
  1114.  
  1115. Following data is required:  Name
  1116.                              Address
  1117.                              EMail Address
  1118.  
  1119. The payage may be done directly via mail (money) or via the 
  1120. account of my Bank. If you like to transfer to bank, ask for 
  1121. my SWIFT etc.
  1122. At near future there will be additional ways (Eurocard) for 
  1123. payage.
  1124.  
  1125. Thorsten Hansen
  1126. Geerzkamp 16a
  1127. 22119 Hamburg
  1128. Germany
  1129.  
  1130. EMail: t.hansen@katodev.de
  1131.  
  1132. @ENDNODE
  1133.  
  1134.